home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 25 / AACD 25.iso / AACD / System / AutoMounter / AutoMounter.readme < prev    next >
Encoding:
Text File  |  2001-08-23  |  9.0 KB  |  197 lines
  1. Short:    AutoMount tool for any changeable disk drive
  2. Uploader: tboeckel@uni-paderborn.de (Thore Boeckelmann)
  3. Author:   tboeckel@uni-paderborn.de (Thore Boeckelmann)
  4. Type:     disk/misc
  5.  
  6. TITLE
  7.   AutoMounter
  8.  
  9.  
  10. VERSION
  11.   37.3
  12.  
  13.  
  14. AUTHOR
  15.   Thore Böckelmann <tboeckel@uni-paderborn.de>
  16.  
  17.  
  18. REQUIREMENTS
  19.   Any Amiga® (compatible) computer with at least OS2.04 and 68020+ cpu.
  20.  
  21.  
  22. DESCRIPTION
  23.   Did you ever had the problem, that you had several Zip® disks, each of them
  24.   probably formatted or partitioned differently with different filesystems like
  25.   FFS, SFS, PFS, CrossDOS, etc? And each time you change the disk you had to
  26.   mount another device driver to access the disk? Wouldn't it be much easier
  27.   just to insert the disk and let the Amiga automatically mount the new driver
  28.   if necessary?
  29.   Or do you have disk drive, that cannot be accessed during booting, so that you
  30.   have to mout the drive "by hand" using a mountfile?
  31.   AutoMounter does exactly all these things. It will monitor any drive you
  32.   configure for disk changes. Every time you insert a disk in one of these
  33.   drives AutoMounter will check if the disk matches any of the already mounted
  34.   devices in the system, and if this check fails it will try to mount it. It
  35.   doesn't matter if the disk uses a filesystem you didn't use before, because
  36.   AutoMounter will try to read the disk's RDB and load the desired filesystem
  37.   from there. This also works for MS-DOS formatted disks, which have no RDB, but
  38.   it requires either CrossDOS or FAT95.
  39.   Please note that the CrossDOS/FAT95 support is very simple. Things like
  40.   partitions in extended partitions and similar things are not supported. I
  41.   think there is no need for such things because of two reasons:
  42.     1. most changeable media are Zip disks, which only have one partition
  43.     2. AutoMounter is no filesystem, just a little tool doing a job in the
  44.        background.
  45.   If you really ever have a disk with several partitions of which not all can be
  46.   mounted by AutoMounter, then please contact me and I will try to change that.
  47.  
  48.   A hint for IOBlix users:
  49.   There is no need to specify the device entries in the tooltypes of AutoMounter
  50.   for Parallelport ZIP-Drivers connected to the IOBlix as long as you start
  51.   SetupIOBlix with the AUTOMOUNT option. IOBlix' AutoMount.demon will use
  52.   AutoMounter as soon as it is running. Without the AutoMount.demon you will of
  53.   course have to handle the drives connected to the IOBlix as any other device.
  54.  
  55.  
  56. USAGE
  57.   You can start AutoMounter from either Workbench or Shell with the following
  58.   options, although Workbench is more suitable:
  59.  
  60.   POLLTIMEOUT/K/N,FAT95/S,DEVICE/M
  61.  
  62.   POLLTIMEOUT/K/N: set the timeout (in seconds) for polling ancient drivers for
  63.     disk changes. Default value is 5 seconds.
  64.  
  65.   FAT95/S: use L:fat95 instead of L:CrossDOSFileSystem for MS-DOS formatted
  66.     disks. This is necessary, because the version of CrossDOS delivered with
  67.     AmigaOS 2.04+ doesn't support long filenames, but not everybody has FAT95
  68.     installed. So if you have MS-DOS formatted disk, but you don't own the
  69.     commercial version of CrossDOS (V6.x, V7.x), then set this option to use
  70.     FAT95.
  71.  
  72.   DEVICE/M: set a device to be monitored for disk changes. Each device entry
  73.     must be given using the following template:
  74.  
  75.     DEVICE/A,UNIT/A/N,MAXTRANSFER=MT/K,DEFFATNAME,POLL/S
  76.  
  77.     DEVICE/A: Exec style device name of the device to be monitored
  78.  
  79.     UNIT/A/N: unit number of the device
  80.  
  81.     MAXTRANSFER=MT/K: some devices don't like the standard value 0x00ffffff
  82.       for MaxTransfer. If you notice any problems then use this option. The
  83.       value must be given in hexadecimal notation, starting with "0x". Some
  84.       IDE/ATAPI drives will choke for other MaxTransfer values than 0x0001fe00.
  85.       Default value is 0x00ffffff.
  86.  
  87.     DEFFATNAME: MS-DOS formatted disks don't have an RDB, so they cannot tell
  88.       AutoMounter the name under which the drive should be mounted. This option
  89.       only affects MS-DOS formatted disks and has no meaning for Amiga formatted
  90.       disk with RDB. This name defaults to "FATC".
  91.       Note: This name must *NOT* include a trailing ":"!!
  92.  
  93.     POLL/S: use this option for those device drivers, that don't support disk
  94.       change notification. These drivers will be asked every <POLLTIMEOUT>
  95.       seconds for a disk change. This option should only be used if disk
  96.       changes are not noticed automatically.
  97.  
  98.     Examples:
  99.       DEVICE=cybppc.device 2
  100.       Monitor cybppc.device unit 2 (my Zip drive) for disk changes.
  101.  
  102.       DEVICE=cybppc.device 2 ZIPC
  103.       Monitor cybppc.device unit 2 for disk changes, but use ZIPC as drive name
  104.       for MS-DOS formatted disks. Usage of fat95 instead of CrossDOSFileSystem
  105.       for MS-DOS formatted disks depends on the global flag <FAT95>.
  106.  
  107.       DEVICE=very_ancient.device 0 FAT poll
  108.       Monitor very_ancient.device unit 0 for disk changes, use FAT as drive name
  109.       for MS-DOS formatted disks. Because very_ancient.device doesn't support
  110.       disk change interrupts, poll it every 5 seconds for a disk change. Usage
  111.       of fat95 instead of CrossDOSFileSystem for MS-DOS formatted disks depends
  112.       on the global flag <FAT95>.
  113.  
  114.   If you start AutoMounter from Shell you must surround every DEVICE
  115.   specification with quotes ("), because of the spaces in the specification
  116.   (e.g. AutoMounter "dev1.device 0" "dev2.device 4 poll")
  117.  
  118.   For the case you have two disks with different geometry, but with the same
  119.   device name in the RDB (for example two ZIP disks) AutoMounter will change the
  120.   name of the newly mounted device that it is unique in the system. That means
  121.   it will append ".0", ".1", ".2", etc to the RDB-saved device name, until the
  122.   device name is unique. You will have two different DOS-devices afterwards for
  123.   the same disk drive, but you will be able to access both disks without the
  124.   need of a remount tool like SCSIMounter or Mounter (supplied with OS3.5/3.9).
  125.   Additionally this behaviour is much safer than unmounting the old drive.
  126.  
  127.   You can start and quit AutoMounter at any time. To quit AutoMounter simply
  128.   start it a second time.
  129.  
  130.   Additionally there are three support tools for AutoMounter: AddAutoDevice,
  131.   RemAutoDevice and ListAutoDevices. With the first two tools you can
  132.   dynamically add or remove a device from disk change monitoring.
  133.  
  134.   The usage template for AddAutoDevice is the same as for every DEVICE tooltype
  135.   of AutoMounter. AddAutoDevice will print the result of adding the device for
  136.   monitoring, either success or failure.
  137.  
  138.   RemAutoDevice just needs the device name and the unit number to remove from
  139.   monitoring. RemAutoDevice will print the result of removing the device from
  140.   monitoring, either success or failure.
  141.  
  142.   ListAutoDevices will print a list of all currently monitored devices.
  143.  
  144.  
  145. INSTALLATION
  146.   Copy AutoMounter where ever you want, but SYS:WBStartup is a very good place.
  147.  
  148.  
  149. KNOWN BUGS
  150.   - cybppc.device seems to tend to crash after removing a device from
  151.     monitoring and changing the disk afterwards. I don't know why this happens
  152.     and if this applies for all of phase5's devices. But I think this not a real
  153.     problem, since all of phase5's devices have a built-in mounter, so there
  154.     should be no real need to run AutoMounter on these devices.
  155.   - 1230scsi.device (Blizzard 1230/1240/1260 SCSI module) doesn't increment its
  156.     diskchange counter. AutoMounter isn't affected by this anymore (V37.2), but
  157.     of course this is a serious bug in phase5's device drivers!
  158.  
  159.  
  160. HISTORY
  161.   37.1 (21.01.2001):
  162.     - initial Aminet release
  163.  
  164.   37.2 (12.02.2001):
  165.     - devices and units are now checked if they are changable media. Drives like
  166.       harddisks or CD-ROMs will be rejected, because they are either not
  167.       changable or they will never contain a valid RDB.
  168.     - recognition of MS-DOS formatted disks is much better now. MBR and
  169.       partition table are now searched for valid entries before trying to mount
  170.       a new device.
  171.     - new option FAT95 now enables support for fat95 filesystem instead of
  172.       CrossDOS.
  173.     - ListAutoDevices contained a wrong version string. Damn quick hacking :)
  174.     - drivers that need polling to detect a disk change will now get a command
  175.       sequence that is similar to the shell command DiskChange to make them
  176.       recognize the new disk.
  177.     - MaxTransfer value can be set now, in case some stupid device drivers
  178.       cannot handle transfers >=128K.
  179.     - mounting FAT formatted disks was completely broken and caused immediate
  180.       crashes. This is fixed now, CrossDOS and FAT95 are fully supported now.
  181.  
  182.   37.3 (23.08.2001):
  183.     - a driver would have been over and over again when the disk geometry could
  184.       not be determinded for some reason. This is fixed now. Even empty drives
  185.       are monitored correctly now.
  186.  
  187.  
  188. COPYRIGHT AND DISCLAIMER
  189.   AutoMounter is copyrighted 2001 by Thore Böckelmann.
  190.   All rights reserved. This program is freeware, so no financial donations  
  191.   required. Redistribution allowed if the package is left unchanged. The author
  192.   is not responsible for any damage caused by the use or misuse of this
  193.   documentation and/or the program(s) it describes.
  194.  
  195.   AutoMounter uses the SmartReadArgs package by Thomas Aglassinger.
  196.  
  197.